Freigeben über


Manage orders - Gets a list of product promotions.

Ruft die verfügbaren Werbeaktionen des Partners ab.

GET https://api.partnercenter.microsoft.com/v{version}/productpromotions
GET https://api.partnercenter.microsoft.com/v{version}/productpromotions?country={country}&segment={segment}

URI-Parameter

Name In Erforderlich Typ Beschreibung
version
path True

string

country
query

string

Das Land.

segment
query

string

Das Segment.

Anforderungsheader

Name Erforderlich Typ Beschreibung
Authorization True

string

Autorisierungs-Bearertoken

ms-correlationid

string

Wird intern zum Nachverfolgen von Anforderungen verwendet. Wenn keine ms-correlationid angegeben wird, generiert der Server für jede Anforderung eine neue.

MS-CV

string

Wird intern zum Nachverfolgen von Anforderungen verwendet. Wenn kein MS-CV bereitgestellt wird, generiert der Server für jede Anforderung eine neue.

ms-requestid

string

Wird für die Idempotenz von Anforderungen verwendet. Wenn keine ms-requestid angegeben wird, generiert der Server für jede Anforderung eine neue anforderung.

Antworten

Name Typ Beschreibung
200 OK

ResourceCollection[Contracts.V1.Models.ProductPromotion]

Die Anforderung war erfolgreich. Der Antworttext enthält eine Liste der Werbeaktionen für den Partner.

Media Types: "application/json", "text/json", "application/xml", "text/xml"

400 Bad Request

Es fehlte eine oder eine ungültige Eingabe. Der Antworttext enthält die Fehlerdetails.

Media Types: "application/json", "text/json", "application/xml", "text/xml"

401 Unauthorized

Die Anforderung wurde nicht authentifiziert. Der Client muss sich zuerst beim Partner-API-Dienst authentifizieren.

Media Types: "application/json", "text/json", "application/xml", "text/xml"

403 Forbidden

Die Anforderung wurde authentifiziert, wurde aber abgelehnt, da der Aufrufer nicht über die Rechte zum Aufrufen verfügt.

Media Types: "application/json", "text/json", "application/xml", "text/xml"

404 Not Found

Die Ressource wurde mit den angegebenen Eingabeparametern nicht gefunden oder nicht verfügbar.

Media Types: "application/json", "text/json", "application/xml", "text/xml"

500 Internal Server Error

Der Partner-API-Dienst oder eine seiner Abhängigkeiten konnte die Anforderung nicht erfüllen.

Media Types: "application/json", "text/json", "application/xml", "text/xml"

Definitionen

Name Beschreibung
Contracts.V1.Models.ProductPromotion
Contracts.V1.Models.ProductPromotionPricingPolicy
Contracts.V1.Models.ProductPromotionProperties
Contracts.V1.Models.ProductPromotionRequiredProduct
Contracts.V1.Models.ProductPromotionTerm
Link
ResourceAttributes
ResourceCollection[Contracts.V1.Models.ProductPromotion]
ResourceLinks
System.Collections.Generic.KeyValuePair[System.String,System.String]

Contracts.V1.Models.ProductPromotion

Name Typ Beschreibung
description

string

endDate

string (date-time)

id

string

name

string

properties

Contracts.V1.Models.ProductPromotionProperties

requiredProducts

Contracts.V1.Models.ProductPromotionRequiredProduct[]

startDate

string (date-time)

Contracts.V1.Models.ProductPromotionPricingPolicy

Name Typ Beschreibung
policyType

string

value

string

Contracts.V1.Models.ProductPromotionProperties

Name Typ Beschreibung
isAutoApplicable

boolean

Contracts.V1.Models.ProductPromotionRequiredProduct

Name Typ Beschreibung
pricingPolicies

Contracts.V1.Models.ProductPromotionPricingPolicy[]

productId

string

skuId

string

term

Contracts.V1.Models.ProductPromotionTerm

Contracts.V1.Models.ProductPromotionTerm

Name Typ Beschreibung
billingCycle

string

duration

string

Name Typ Beschreibung
body

string

headers

System.Collections.Generic.KeyValuePair[System.String,System.String][]

method

string

uri

string

ResourceAttributes

Name Typ Beschreibung
etag

string

objectType

string

ResourceCollection[Contracts.V1.Models.ProductPromotion]

Name Typ Beschreibung
attributes

ResourceAttributes

items

Contracts.V1.Models.ProductPromotion[]

links

ResourceLinks

totalCount

integer (int32)

Name Typ Beschreibung
next

Link

previous

Link

self

Link

System.Collections.Generic.KeyValuePair[System.String,System.String]

Name Typ Beschreibung
key

string

value

string